README.win32: Mention about (re-)generating project files

This adds instructions to aid one to build with the Visual Studio projects
directly from a GIT checkout, or to re-generate the project files with
various options and features enabled (which are not enabled by default
in the release tarballs).

diff --git a/README.win32 b/README.win32
index f208a49ed9819f9ae7f1a60fafec223ba85c79fd..1a5f907e7ba38a253165cbc5777019103046b539 100644 (file)
--- a/README.win32
+++ b/README.win32
@@ -218,6 +218,42 @@ It may still be possible to carry out the build and build the introspection file
 using older versions of GLib and GObject-Introspection, but please note that this is not recommended\r
 and one is on his/her own by doing so.\r
 \r
+It is now supported to build with the Visual Studio projects directly\r
+from a GIT checkout.  Run in a Visual Studio command prompt, in \r
+$(srcroot)/win32:\r
+\r
+nmake /f bootstrap-msvc.mak [PYTHON=...] [PERL=...] [FONT_FEATURES_DEMO=1] [FONT_FEATURES_USE_PANGOFT2=1] [USE_EGL=1]\r
+\r
+where PYTHON and PERL are the respective paths to the Python and PERL\r
+interpreters, if they are not in your %PATH%-they are both required to\r
+generate the full sets of project files, as well as the auxiliary build\r
+files and headers that is not available in a GIT checkout and must be\r
+generated prior to opening the project files.\r
+\r
+For FONT_FEATURES_DEMO, FONT_FEATURES_USE_PANGOFT2 and USE_EGL, please \r
+refer to win32\README_FEATURES_MSVC.md for more details, to enable \r
+features that is optional and not enabled by default (i.e. in the release\r
+tarballs).\r
+\r
+It is also possible to regenerate some or all of the visual studio \r
+projects with the following, if necessary:\r
+\r
+nmake /f generate-msvc.mak [PYTHON=...] [FONT_FEATURES_DEMO=1] [FONT_FEATURES_USE_PANGOFT2=1] [USE_EGL=1] <target>\r
+\r
+Where target can be (they will update all related VS2008~2022 projects):\r
+\r
+regenerate-demos-h-win32: Regenerate the gtk3-demo projects along with \r
+demos.h.win32, useful to enable or disable the Font Features demo.\r
+\r
+regenerate-gdk-vsproj: Regenerate all the GDK projects with broadwayd,\r
+useful to enable or disable EGL on Windows.\r
+\r
+regenerate-gtk-vsproj: Regenerate the GTK and libgail-util library\r
+projects.\r
+\r
+regenerate-all-msvc-projs: Re-generate all project files, and re-copy all \r
+the Visual Studio 2010 project files for VS 2012~2022.\r
+\r
 3) Using Meson (for Visual Studio and MinGW builds)\r
 ---\r
 \r